Prizm Content Connect
Installation on a Headless Environment
Installation Guide > Linux > Installation on a Headless Environment

How To Install PCC in a Linux Headless Environment

Required Action

Before starting the steps below, make sure you have downloaded the necessary RPM or DEB package to the following location: /home/username/Downloads

The '#' sign in command examples denotes running the command as the root user. All command lines preceded by the '>' sign are the example output of that command, where applicable.

Step 1: Install LibreOffice

Install LibreOffice (if it was not already installed with your distribution). Download and install it from the Package Manager on your distribution. If it is not available to download from the Package Manager, then download it from here: http://www.libreoffice.org/download

In-depth installation instructions are available here: http://www.libreoffice.org/get-help/installation/linux/

CentOS / Red Hat / Fedora

  1. Check to see if a recent version of the CentOS/Red Hat/Fedora release includes LibreOffice in the standard repository by running the following commands:

Example
Copy Code 
# yum update
# yum search libreoffice

  1. If the release is available, install it through the Package Manager by running this command:

Example
Copy Code 
# yum install libreoffice

Manual Installation of LibreOffice in CentOS

  1. Verify that the LibreOffice package has been downloaded to: /home/username/Downloads. Run the following commands:
Example
Copy Code 
# tar xvf LibreOffice_4.1.3_Linux_x86-64_rpm.tar.gz
# yum install LibreOffice_4.1.3.2_Linux_x86-64_rpm/RPMS/*.rpm
  1. This should install LibreOffice to /opt. To verify, run the following command:

Example
Copy Code 
# ls /opt | grep libreoffice
> libreoffice4.1

  1. Write down the location because you will need it below in the Setup portion of the installation process. (Example location: /opt/libreoffice4.1)

Ubuntu / Debian

  1. Install LibreOffice through the Package Manager (recent versions of the release should include LibreOffice in the standard repository). Run the following command:

Example
Copy Code 
# apt-get install libreoffice

Step 2: Install the Prizm Content Connect Package

CentOS / Red Hat / Fedora

  1. Run the following command to install the package:

Example
Copy Code 
# yum install --nogpgcheck prizmcc_<version>.x86_64.rpm

Ubuntu / Debian

  1. Run the following commands to install the package:

Example
Copy Code 
# apt-get install gdebi
# gdebi prizmcc_<version>.amd64.deb

Step 3: Setup

  1. Run the following commands to initiate setup:

Example
Copy Code 
# cd /usr/share/prizm
# sh ./setup.sh

  1. The setup may prompt you for the LibreOffice location if it was not already installed on your distribution. Provide the location which you obtained in the 'Step 1 - Install LibreOffice' section above. (Example location: /opt/libreoffice4.1)
Important: The setup script will attempt to start the license utility and it will fail since it is a GUI component. This currently is the expected behavior and will be resolved when you license the software afterward.
  1.  After the script completes, run this command to obtain a 30-day evaluation license:

Example
Copy Code 
# ./java/jre6-linux-x86-64/bin/java -jar ./plu/plu.jar eval get youremail@example.com

If you already have a license for PCC, you can use one of the other licensing options, detailed in the Command Line Mode Licensing section of  the help.
  1. To confirm the licensing has succeeded, run the following command, which will output your license key:

Example
Copy Code 
# cat ./conf/proxyserver_jar.properties | grep license_key
> license_key=<long string>

  1. Start the ProxyServer and PCCIS services by running the following commands:

Example
Copy Code 
# cd /usr/share/prizm/scripts
# sh proxyserver.sh start
# sh pccis.sh start

  1. If both the Proxy Server and PCCIS have started, then the installation process is complete.

However, if you have an error in the Proxy Server log stating that it cannot connect to the Office converter Worker-1 instance, then you must continue to the 'Step 4 - Running an X Virtual Framebuffer' section below.

Step 4: Running an X Virtual Framebuffer Server

A full version of the X11 server is not required to run PCC. However, the minimum requirement is the X Virtual Framebuffer Server, which you can install and run separately from an entire X11 instance.

  1. To install the X Virtual Framebuffer Server, run the following command:

Debian/Ubuntu

Example
Copy Code 
# sudo apt-get install xvfb

Red Hat / CentOS

Example
Copy Code 
# yum install xorg-x11-server-Xvfb
  1. Start the service by running the following command, and then export the instance to the DISPLAY environment variable expected by the Prizm service:

Example
Copy Code 
# Xvfb :20 >/dev/null 2>&1 &
# export DISPLAY=:20

  1. Start the Proxy Server:

Example
Copy Code 
# /usr/share/prizm/scripts/proxyserver.sh start

Required:

The X Virtual Framebuffer Server must be running any time that the Prizm service is running.

Suggested:

It may be appropriate to create a script that will start the Xvfb service and ProxyServer (the 3 lines above) to execute whenever the machine is restarted.

  1. The installation process is now complete.

 

 

©2014. Accusoft Corporation. All Rights Reserved.

Send Feedback